<html>
	<head>
		<style type="text/css">
			/* <![CDATA[ */
			@import "http://www.tigris.org/branding/css/tigris.css";
			@import "http://www.tigris.org/branding/css/inst.css";
			/*  ]]> */
		</style>
		<link rel="stylesheet" type="text/css" href="http://www.tigris.org/branding/css/print.css" media="print" />
		<script src="http://www.tigris.org/branding/scripts/tigris.js" type="text/javascript"/>
		<title>Atlas Project Documentation - Maunal</title>
	</head>

	<body>
		<div class="h2 app" style="border-left: 0px" id="customcontent">
		    <h2>Configuration</h2>
		    <h3>Description</h3>
		    <p>
		    	Atlas strives to provide an environment where artifacts should not have to be rebuilt in order to change runtime properties.  In this spirit,
		    	runtime configuration is achieved via the
		    	<a href="http://atlas.tigris.org/svn/atlas/trunk/atlas-java/src/main/java/org/tigris/atlas/config/ConfigurationManager.java">ConfigurationManager</a> class.
		    	This class uses a system property named config.location to specific a directory in which it can find property files.  At runtime, one can leverage
		    	ConfigurationManager's getConfiguration method to find a specific properties file.  From this point, one can simply leverage Java's Properties class.
		    	The following is an example of how to specify the system property  required by ConfigurationManager.
			<p>
				-Dconfig.location=&lt;come reachable location for the JVM&gt;
			</p>
			<p>
				If the ConfigurationManager cannot find the config.location system property, then an IllegalStateException is thrown.
			</p>
			<h3>Usage Example</h3>
			<p>
				private static final String SERVICE_DELEGATE_PROPERTIES = "/service-delegate.properties";<br/>
				Properties serviceDelegateProperties = null;<br/>
				try {<br/>
				&nbsp;&nbsp;&nbsp;&nbsp;serviceDelegateProperties = ConfigurationManager.getConfiguration(SERVICE_DELEGATE_PROPERTIES);<br/>
				} catch (IllegalStateException ex) {<br/>
				&nbsp;&nbsp;&nbsp;&nbsp;//we report, you decide<br/>
				}<br/>
			</p>
		</div>
	</body>
</html>